home *** CD-ROM | disk | FTP | other *** search
/ Aminet 1 (Walnut Creek) / Aminet - June 1993 [Walnut Creek].iso / aminet / os20 / cdity / smaus117.lha / SMaus.dok < prev    next >
Text File  |  1993-04-06  |  34KB  |  711 lines
  1.  
  2.  
  3.  
  4.  
  5.                                Dokumentation
  6.  
  7.                                     zu
  8.  
  9.                                    SMaus
  10.  
  11.  
  12.                    Copyright © 1991, 1992 Stefan Sticht
  13.  
  14.                             All rights reserved
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.                                  Shareware
  22.  
  23.      SMaus ist nicht  Freeware,  sondern  Shareware.  Wenn  Sie  SMaus
  24.      benutzen, müssen Sie Ihre Kopie von SMaus registrieren lassen.
  25.  
  26.  
  27.                                Registration
  28.  
  29.      Zum Registrieren drucken Sie bitte die Datei  Registrierung  aus.
  30.      Sie können dies tun, indem  Sie  das  Piktogramm  des  Programmes
  31.      Printfiles in der Schublade Tools Ihrer Extras2.0-Diskette einmal
  32.      anklicken, die Shift-Taste gedrückt halten und einen  Doppelklick
  33.      auf das Piktogramm Registrierung machen. Schicken Sie  mir  bitte
  34.      dieses Formular ausgefüllt und mit  einem  Scheck,  Bargeld  oder
  35.      einer separaten Postanweisung zu. Die Registrierungsgebühr ist DM
  36.      5.-. Vielen Dank.
  37.  
  38.  
  39.                               Keine Garantie
  40.  
  41.      Die Nutzung von SMaus erfolgt auf eigene Gefahr. Weder der  Autor
  42.      noch irgendein Distributor haftet für irgendwelche  Schäden,  die
  43.      durch dieses Programm verursacht werden.
  44.  
  45.  
  46.                                Distribution
  47.  
  48.      Sie dürfen SMaus so oft kopieren und weitergeben, wie Sie wollen,
  49.      solange Sie immer alle Dateien zu  SMaus  weitergeben  und  diese
  50.      unverändert lassen und solange dies unentgeltlich oder nur  gegen
  51.      eine geringe  Auwandsentschädigung  geschieht.  SMaus  darf  über
  52.      Mailboxen  oder  elektronische  Datennetze   vertrieben   werden,
  53.      solange dies ebenfalls unentgeltlich geschieht.  SMaus  darf  als
  54.      Beigabe zu kommerziellen  Produkten  nur  mit  der  schriftlichen
  55.      Genehmigung  des  Autors  vertrieben  werden.  Diese  Genehmigung
  56.      erhalten Sie in der Regel durch  ein  vollwertiges  Exemplar  des
  57.      Produktes   für   den   Autor   und   einen   Hinweis   auf   den
  58.      Shareware-Status von SMaus in der  Dokumentation  des  Produktes.
  59.      Eine Vertrieb von SMaus als eigenständiges kommerzeilles  Produkt
  60.      ist ausnahmslos untersagt.
  61.  
  62.      SMaus_nowin ist nur eine Spezialversion von SMaus ohne graphische
  63.      Benutzeroberfläche, für die obiges ebenfalls gilt.
  64.  
  65.  
  66.                           Beschreibung von SMaus
  67.  
  68.      SMaus soll das Programm Autopoint, welches im Rahmen von  AmigaOS
  69.      2.0 oder größer ausgeliefert wird, ersetzen. SMaus ist stark kon-
  70.      figurierbar.
  71.  
  72.      Das primäre Ziel ist wie bei Autopoint,  das  Fenster  unter  dem
  73.      Mauspfeil zu aktivieren.  Es  gibt  mehrere  Aktionen,  die  eine
  74.      Aktivierung veranlassen:
  75.  
  76.      Mausbewegung: Nach oder bei einer Mausbewegung  wird das  Fenster
  77.           unter dem Mauspfeil aktiviert. Sie können einstellen, bis zu
  78.           welcher  Geschwindigkeit  der  Mausbewegung  Fenster  sofort
  79.           aktiviert werden sollen.  Im  Extremfall  wird  das  Fenster
  80.           unter dem  Mauspfeil  erst  nach  dem  Stillstand  der  Maus
  81.           aktiviert, um das  lästige  "Hüpfen"  des  Mauspfeiles  beim
  82.           Bewegen über Fenstergrenzen  hinweg  zu  verhindern.  Dieses
  83.           Hüpfen  wird  durch   das   Einfärben   des   Fensterrahmens
  84.           verursacht. Hat man einen schnelleren  Rechner,  z.B.  Amiga
  85.           3000, so kann man das Fenster auch sofort aktivieren lassen,
  86.           da sich hier das "Hüpfen" kaum  bemerkbar  macht,  zumindest
  87.           nicht bei langsamen Mausbewegungen.
  88.  
  89.      Zeit: Leider kann sich  SMaus,  wie  auch  Autopoint,  nicht  vom
  90.           Betriebssystem informieren  lassen,  ob  ein  neues  Fenster
  91.           geöffnet wurde oder  ob  der  Bildschirm  gewechselt  wurde.
  92.           Deswegen  müssen  SMaus  und   Autopoint   in   regelmäßigen
  93.           Abständen prüfen, ob dies der Fall ist. Diese Technik  nennt
  94.           man "pollen" und ist auf Multitaskingsystemen wie dem  Amiga
  95.           unerwünscht, da sie unnötige Rechenzeit verbraucht. Da  aber
  96.           immer das Fenster unter dem Mauspfeil  aktiv  bleiben  soll,
  97.           muß  geprüft  werden,  ob  vielleicht  ein  anderes  Fenster
  98.           geöffnet  und  aktiviert  wurde,  welches  nicht  unter  dem
  99.           Mauspfeil ist, ebenso ob der  Bildschirm  gewechselt  wurde.
  100.           Bei SMaus können Sie zumindest die Zeitabstände, nach  denen
  101.           geprüft wird, einstellen. Sie können  die  Überprüfung  ganz
  102.           ausschalten  oder  die  Zeitintervalle  vergrößern,  um  den
  103.           Rechenzeitverbrauch  zu  senken.   Mit   einem   annehmbaren
  104.           Zeitintervall benötigt SMaus deutlich weniger Rechenzeit als
  105.           Autopoint. Durch die Option "Aktivieren auf Tastendruck" ist
  106.           dieses Zeitintervall auch ohne  größere  Einschränkung  sehr
  107.           groß wählbar.
  108.  
  109.      Tastendruck: Auf Wunsch  aktiviert  SMaus  bei  einem  beliebigen
  110.           Tastendruck das Fenster unter dem Mauspfeil.
  111.  
  112.      Mausbewegung über Tastatur: SMaus  erkennt  auch  Mausbewegungen,
  113.           die über einer der beiden Amiga-Tasten  zusammen  mit  einer
  114.           Cursortaste vorgenommen werden. SMaus  aktiviert  in  diesem
  115.           Fall das Fenster nach dem Stillstand des Mauspfeiles.
  116.  
  117.      Sehr oft ist es aber auch unerwünscht, daß das Fenster unter  dem
  118.      Mauspfeil aktiviert wird. Folgende Optionen verhindern, daß SMaus
  119.      ein Fenster aktiviert:
  120.  
  121.      Fenstertitel: Sie können Titel von Fenstern  angeben,  die  nicht
  122.           deaktiviert werden sollen. Titel  können  dabei  mit  Jokern
  123.           (Wildcards) angegeben werden. Sie können z.B. bestimmen, daß
  124.           Fenster, deren Titel  mit  den  Buchstaben  "Arq"  beginnen,
  125.           nicht  deaktiviert  werden  sollen,  da  es  sich  dabei  um
  126.           Requester handelt, die Sie gerne  sofort  mit  der  Tastatur
  127.           beantworten möchten.
  128.  
  129.      Bildschirmtitel: Sie können Titel von Bildschirmen  angeben,  auf
  130.           denen SMaus generell funktionslos bleiben  soll.  Auch  hier
  131.           können Sie wieder Joker einsetzen.
  132.  
  133.      Aktives Texteingabefeld: Fenster  mit einem  aktiven Texteingabe-
  134.           feld werden auf Wunsch nicht deaktiviert.
  135.  
  136.      Systemrequester: werden nicht deaktiviert, solange Sie nicht  ein
  137.           Programm wie  Arq  benutzen,  welches  Systemrequester  ver-
  138.           ändert.
  139.  
  140.      Wollen  Sie,  daß  Fenster  zwar  bei  einem  Tastendruck   nicht
  141.      deaktiviert werden sollen,  aber  bei  Mausbewegungen  schon,  so
  142.      können Sie auch dies einstellen.
  143.  
  144.      Bereits  aktive  Fenster  werden  natürlich  nicht  noch   einmal
  145.      aktiviert.
  146.      SMaus hat ein Fenster, in dem alle Einstellungen verändert werden
  147.      können.
  148.      SMaus ist systemkonform programmiert. Es werden  keine  Betriebs-
  149.      systemroutinen verändert. SMaus wurde auf einem  Amiga  3000  mit
  150.      SAS/C entwickelt und unter Benutzung von  Enforcer  und  Mungwall
  151.      getestet.
  152.  
  153.  
  154.                            Systemanforderungen
  155.  
  156.      SMaus benötigt AmigaOS 2.0, mindestens Kickstart  V37.175.  Diese
  157.      Version wird auch als AmigaOS 2.04 bezeichnet. Machen Sie einfach
  158.      folgendes:  Rufen  Sie  den  Menüpunkt  About  bzw.  Version  der
  159.      Workbench auf. Es  öffnet  sich  ein  Requester,  der  Ihnen  die
  160.      Version Ihrer Kickstart und Workbench verrät. Steht bei Kickstart
  161.      eine Versionsnummer kleiner  als  37.175,  so  sollten  Sie  sich
  162.      unbedingt die neueste Kickstart besorgen, und nicht nur, um SMaus
  163.      testen zu können. Kickstart und Workbench 2.04 sind im Fachhandel
  164.      erhältlich.
  165.  
  166.      Haben Sie die Workbench 2.1 oder größer,  können Sie die Sprache,
  167.      die SMaus verwenden soll, über  den   Preferences-Editor "Locale"
  168.      einstellen. Die Versionsnummer können  Sie  wie  oben  ermitteln.
  169.      Steht bei Workbench V38.xx oder höher, benutzen Sie Workbench 2.1
  170.      oder höher. Workbench 2.1  ist  im  Fachhandel  erhältlich.  Ohne
  171.      Workbench 2.1 sind alle Texte von SMaus in englischer Sprache.
  172.  
  173.  
  174.                            So starten Sie SMaus
  175.  
  176.      Bevor Sie SMaus testen, vergewissern Sie sich bitte, daß Sie  das
  177.      Programm Autopoint nicht auch benutzen. Starten Sie das  Programm
  178.      Exchange, das Sie üblicherweise in der Schublade Utilities  Ihrer
  179.      Systemdiskette finden. In dem Fenster,  das  Exchange  öffnet  --
  180.      eventuell  müssen   Sie   erst   das   von   Ihnen   eingestellte
  181.      Tastaturkürzel für Exchange drücken, im Zweifelsfalle starten Sie
  182.      Exchange ein zweites Mal, dann sollte sich das Fenster  auf  alle
  183.      Fälle öffnen -- durchsuchen Sie die Liste  der  Commodities  nach
  184.      einem Programm namens Autopoint. Finden Sie dieses  Programm,  so
  185.      wählen  Sie  es  aus  und  drücken  den  Schalter  "Remove"  bzw.
  186.      "Entfernen", um es vorübergehend auszuschalten.
  187.  
  188.      SMaus starten  Sie  einfach  durch  einen  Doppelklick  auf  sein
  189.      Piktogramm. Wenn Sie die Optionen von SMaus noch  nicht  geändert
  190.      haben, so öffnet sich nach dem Start sofort dessen  Fenster.  Sie
  191.      können das  Fenster  auch  mit  Hilfe  von  Exchange  oder  durch
  192.      nochmaliges Starten von SMaus jederzeit öffnen. Starten Sie SMaus
  193.      ein zweites Mal, so informiert SMaus die erste Kopie im Speicher,
  194.      es solle sein Fenster öffnen und endet wieder. Sie  können  SMaus
  195.      natürlich auch über die Shell starten, am besten mit
  196.  
  197.                            Run >NIL: <Pfad>SMaus
  198.  
  199.      wobei Sie für <Pfad> den Pfad  zu  SMaus,  z.B.  dh0:Tools/  ein-
  200.      setzen.  Nun folgt  eine Beschreibung der Optionen von SMaus.  Am
  201.      besten testen Sie die Wirkung der Optionen sofort.
  202.  
  203.  
  204.                         Die verschiedenen Optionen
  205.  
  206.      Aktivierungsschwelle/Activation Threshold:
  207.  
  208.      Im Fenster von SMaus finden Sie ganz oben einen Schieberegler für
  209.      die   Aktivierungsschwelle.   Sie   gibt   an,   unter    welcher
  210.      Geschwindigkeit der  Mausbewegung  das  Fenster  unter  der  Maus
  211.      aktiviert werden soll. Die Geschwindigkeit  wird  in  Pixel/Event
  212.      angegeben, da SMaus nur feststellen kann, daß sich der  Mauspfeil
  213.      um so und soviel Punkte horizontal und/oder vertikal bewegt  hat.
  214.      Bewegen Sie  die  Maus  schnell,  ist  die  horizontale/vertikale
  215.      Bewegung dementsprechend groß und  der  von  SMaus  festgestellte
  216.      Wert Pixel/Event ebenso. Stellen Sie 0 Pixel/Event ein,  so  wird
  217.      erst nach dem Stillstand der Maus das Fenster unter dem Mauspfeil
  218.      aktiviert. Dieser Wert ist  voreingestellt.  Stellen  Sie  diesen
  219.      Wert nun auf 5 Pixel/Event. Bewegen Sie nun die Maus über mehrere
  220.      Fenster hinweg. Nun werden die Fenster unter dem Mauspfeil sofort
  221.      aktiviert, auch wenn Sie die  Maus  nicht  loslassen.  Haben  Sie
  222.      einen Amiga mit 68000-Prozessor, wird Ihnen  dies  mißfallen,  da
  223.      der Mauspfeil aus schon genannten  Gründen  "hängenbleibt",  wenn
  224.      ein  Fenster  aktiviert  wird.  Benutzer  von  Amigas  mit  68030
  225.      Prozessor werden aber vielleicht mit dieser Einstellung arbeiten.
  226.      Verringern Sie jetzt  einmal  den  Wert  auf  3  Pixel/Event  und
  227.      bewegen Sie die Maus sehr schnell über ein  Fenster  hinweg:  das
  228.      Fenster wurde nicht aktiviert. Wenn Sie die  Maus  langsam  genug
  229.      bewegen, wird es  aktiviert.  Meine  bevorzugte  Einstellung  auf
  230.      einem 25MHz Amiga 3000 ist 3 Pixel/Event. Sie können übrigens den
  231.      Schieberegler auch mit der Tastatur bewegen: Mit  "w"  vergrößern
  232.      Sie den Wert, mit "W" verkleinern Sie ihn. Das W in Aktivierungs-
  233.      schwelle ist deshalb auch unterstrichen.
  234.  
  235.      Reaktivierungszeit/Reactivate windows after:
  236.  
  237.      Mit  dem  zweitem  Schieberegler  können  Sie  das  Zeitintervall
  238.      angeben, nach dem SMaus prüft, ob das Fenster unter dem Mauspfeil
  239.      noch das aktive ist. Ist es dies nicht, wird es reaktiviert.  Sie
  240.      können diese Zeit in einer Genauigkeit von einer zehntel  Sekunde
  241.      bestimmen. 0/10 schaltet diese Funktion aus.  Voreingestellt  ist
  242.      5/10 Sekunden,  also  wird  jede  halbe  Sekunde  geprüft.  Meine
  243.      bevorzugte Einstellung ist 10/10  Sekunden,  also  eine  Sekunde.
  244.      Dies ist jedoch deutlich langsamer,  als  Autopoint  reaktivieren
  245.      wuerde, dafuer ist  die  Rechnerauslastung  wesentlich  geringer.
  246.      Testen können Sie diese Option folgendermaßen:  Öffnen  Sie  eine
  247.      Shell. In der Shell tippen Sie "NewShell".  Es  öffnet  sich  ein
  248.      neues Fenster, ohne daß Sie die Maus bewegt haben. Wenn das  neue
  249.      Fenster nicht gerade unter dem Mauspfeil geöffnet wurde, so wurde
  250.      es  bereits  wieder  deaktiviert  und  das   alte   Shell-Fenster
  251.      reaktiviert. Wurde das neue Fenster unter dem Mauspfeil geöffnet,
  252.      verschieben Sie die Maus bzw. die Shell so, daß nach dem Kommando
  253.      NewShell das Fenster der neuen Shell nicht  unter  dem  Mauspfeil
  254.      ist.  Wenn  Sie  gleichzeitig   die   Option   "auf   Tastendruck
  255.      aktivieren"  einschalten,  können  Sie  dieses   Intervall   ohne
  256.      Nachteile sehr groß wählen, da eine Reaktivierung vor  allem  für
  257.      Tastatureingaben  notwendig  ist.  "Auf  Tastendruck  aktivieren"
  258.      aktiviert aber sowieso das Fenster unter dem Mauspfeil bei  einem
  259.      Tastendruck.
  260.  
  261.      Diese Fenster nicht deaktivieren/Don't deactivate this windows:
  262.  
  263.      In diesem Texteingabefeld können Sie Titel von Fenstern  angeben,
  264.      die nicht deaktiviert werden  sollen.  Sie  können  hier  normale
  265.      AmigaOS Joker/Wildcards benutzen. Wollen Sie z.B. Fenster,  deren
  266.      Titel mit den drei  Buchstaben  Arq  beginnen,  nicht  von  SMaus
  267.      deaktivieren lassen,  dann  tragen  Sie  in  das  Texteingabefeld
  268.      "Arq#?" ein. #? dient hier als Joker, der beliebige  Zeichen  be-
  269.      liebig oft zuläßt. Sie können hier die ganze Palette  der  Amiga-
  270.      DOS-Joker verwenden, wie sie auch bei DOS-Befehlen wie  Dir  oder
  271.      List Verwendung finden. Eine Beschreibung der Joker finden Sie in
  272.      Ihrer AmigaDOS 2.0 Beschreibung. Bitte Beachten Sie, daß zwischen
  273.      Groß-  und  Kleinschreibung  unterschieden  wird.   Hier   einige
  274.      Beispiele:
  275.  
  276.      (Arq#?|#?frage#?) - alle Fenstertitel,  die  mit  den  Buchstaben
  277.      "Arq" beginnen oder in ihrem Titel die Folge "frage" aufweisen.
  278.  
  279.      (#?[Rr]equest|Arq#?|#?[Mm]essage|Choose #?) - alle Titel, die auf
  280.      "Request" oder "request" enden -- [Rr] paßt auf alle Zeichen, die
  281.      in den eckigen Klammern vorkommen -- oder mit "Arq" beginnen oder
  282.      auf "Message" oder "message" enden oder mit "Choose " beginnen.
  283.  
  284.      Meldet AmigaOS einen Fehler, meist  ist  er  syntaktischer  Art,
  285.      etwa eine vergessene Klammer, so informiert Sie SMaus darüber.
  286.  
  287.      Auf diesen Schirmen funktionslos/Do nothing on these screens:
  288.  
  289.      In diesem  Texteingabefeld  können  Sie  Titel  von  Bildschirmen
  290.      angeben, auf denen SMaus absolut funktionslos bleiben soll.  Auch
  291.      hier können Sie, wie oben, alle AmigaDOS-Joker benutzen.
  292.  
  293.      Dieses Fenster öffnen mit/Hotkey to open this window:
  294.  
  295.      Dieses Texteingabefeld bestimmt die  Tastenkombination,  die  das
  296.      Fenster von  SMaus  öffnen  läßt.  Das  Fenster  von  SMaus  wird
  297.      übrigens auf dem vordersten Bildschirm  geöffnet,  sofern  dieser
  298.      ein öffentlicher Bildschirm ist. Wenn nicht, wird das Fenster auf
  299.      dem voreingestellten öffentlichen  Bildschirm  geöffnet,  welcher
  300.      normalerweise der Workbench-Bildschirm ist. Jede erdenkliche Tas-
  301.      tenkombination kann auf folgende Weise beschrieben werden:
  302.  
  303.                             Qualifizierer Taste
  304.  
  305.      wobei Qualifizierer und Taste folgendes repräsentieren:
  306.  
  307.      Qualifizierer: keines, eines oder mehrere der  folgenden  Schlüs-
  308.      selwörter:
  309.              lshift - linke Shift-Taste
  310.              rshift - rechte Shift-Taste
  311.               shift - eine der beiden Shift-Tasten
  312.            capslock - die CapsLock-Taste
  313.                caps - die CapsLock-Taste oder eine der Shift-Tasten
  314.             control - die Ctrl-Taste
  315.                lalt - die linke Alt-Taste
  316.                ralt - die rechte Alt-Taste
  317.                 alt - eine der beiden Alt-Tasten
  318.            lcommand - die linke Amigataste
  319.            rcommand - die rechte Amiga-Taste
  320.          numericpad - eine Taste des Zehnertastenblockes
  321.              repeat - eine Taste, die gerade wiederholt wird
  322.            upstroke - nur das Loslassen der Taste zählt
  323.           -upstroke - das Drücken und das Loslassen einer Taste zählt
  324.      Ein "-" vor einem  Qualifizierer  bedeutet,  wenn  nicht  anderes
  325.      angegeben, daß dieser nicht beachtet werden soll.
  326.  
  327.      Taste:  eines  der  folgenden  Schlüsselwörter:   comma,   space,
  328.      backspace, tab, enter, return, esc, del, up, down,  right,  left,
  329.      help, f1, f2, f3, f4, f5, f6, f7, f8, f9, f10  oder  ein  Zeichen
  330.      wie z.B. A, 1, Ü, |
  331.  
  332.      Beispiele:
  333.  
  334.      lalt f1 - linke Alt-Taste und F1
  335.      control alt shift help - Ctrl, linke oder rechte Alt-Taste, linke
  336.           oder rechte Shift-Taste und Help-Taste
  337.      lcommand s - linke Amiga-Taste und s
  338.  
  339.      Hinweis: Diese Liste der Namen für  Tasten  ist  Bestandteil  der
  340.      commodities.library und nicht Bestandteil von  SMaus.  Bei  neuen
  341.      Versionen der commodities.library könnten  diese  Namen  geändert
  342.      oder ergänzt werden. SMaus verwendet dann automatisch  die  neuen
  343.      Namen. Überprüfen Sie deshalb diese Liste anhand der Beschreibung
  344.      der Systemsoftware, wenn Sie eine neuere Version  als  V2.04  von
  345.      AmigaOS benutzen.
  346.  
  347.      Bestimmen   Sie   keine   Tastenkombination,   können   Sie   das
  348.      SMaus-Fenster immer  noch  mit  Hilfe  von  Exchange  oder  durch
  349.      nochmaliges Starten von SMaus öffnen.
  350.  
  351.      Mausbewegung aktiviert/Activate by mouse:
  352.  
  353.      Mit diesem Schalter  können  Sie  einstellen,  ob  Mausbewegungen
  354.      Fenster niemals  (never),  normalerweise  (normally)  oder  immer
  355.      (always)  aktivieren  sollen.  "Immer"  bedeutet  hier,  daß  das
  356.      Fenster unter dem Mauspfeil aktiviert wird, auch wenn das  gerade
  357.      aktuelle Fenster aufgrund einer der oben genannten  Gründe  nicht
  358.      deaktiviert  werden  soll.  "Normalerweise"  bedeutet,  daß   das
  359.      Fenster unter dem Mauspfeil aktiviert wird, wenn nicht einer  der
  360.      oben  genannten   Gründe   wie   aktives   Texteingabefeld   dies
  361.      verhindert.
  362.  
  363.      Auf Tastendruck aktivieren/Activate by key:
  364.  
  365.      Schalten Sie diese Option ein, wird bei jedem Druck  einer  Taste
  366.      der Tastatur das Fenster unter dem Mauspfeil aktiviert, falls  es
  367.      dies nicht schon ist.
  368.  
  369.      Fenster mit aktivem Texteingabefeld nicht deaktivieren/
  370.      Don't deactivate windows with active string gadget:
  371.  
  372.      Durch diesen Schalter können Sie verhindern, das ein Fenster  mit
  373.      aktivem Texteingabefeld deaktiviert  wird.  Dies  ist  z.B.  sehr
  374.      nützlich,  wenn  Sie  den  Texteditor  CygnusEd  Professional   2
  375.      benutzen.  Öffnen  Sie  beim  CygnusEd  den   Suchrequester   per
  376.      Tastatur,  so  wird  ein  Fenster  mit  aktiven   Texteingabefeld
  377.      aktiviert. Benutzen Sie ein Hilfsprogramm wie Autopoint, so  wird
  378.      dieses Fenster sofort wieder daktiviert und Sie müssen  erst  den
  379.      Mauspfeil in dieses  Fenster  bewegen.  SMaus  erkennt,  daß  das
  380.      aktive Fenster ein aktives Texteingabefeld  hat  und  deaktiviert
  381.      dieses Fenster nicht, wenn diese  Option  eingeschaltet  ist.  So
  382.      können Sie sofort den zu suchenden Text  in  das  Texteingabefeld
  383.      tippen und die Suche starten.
  384.      Beachten Sie bitte, daß diese  Option  nicht  100%  funktioniert,
  385.      wenn Sie die Reaktivierungszeit zu klein  einstellen.  Denn  dann
  386.      kann es passieren, daß ein Programm  ein  Fenster  aufmacht,  und
  387.      noch bevor  das Programm  das  Texteingabefeld  aktiviert,  SMaus
  388.      dieses Fenster   deaktiviert.  Dagegen   hilft  das  Erhöhen  der
  389.      Reaktivierungszeit.
  390.  
  391.  
  392.               Sonstige Funktionen des Konfigurationsfensters
  393.  
  394.      Verstecken/Hide:
  395.  
  396.      Dieser Schalter oder das  Schließsymbol  des  Fensters  schließen
  397.      das Fenster, ohne SMaus zu beenden. Diese Funktion ist auch  über
  398.      die Taste ESC zu erreichen.
  399.  
  400.      Information/About:
  401.  
  402.      Hiermit öffnet SMaus ein Dialogfenster, in dem Informationen über
  403.      SMaus gezeigt werden.
  404.  
  405.      Beenden/Quit:
  406.  
  407.      Mit diesem Schalter beenden Sie SMaus.
  408.  
  409.  
  410.                      Menü des Konfigurationsfensters
  411.  
  412.      Konfiguration laden/speichern / Configuration open/save:
  413.  
  414.      Mit diesen beiden Menüpunkten können Sie sämtliche  Einstellungen
  415.      von SMaus in einer frei wählbaren  Konfigurationsdatei  speichern
  416.      oder aus einer beliebigen SMaus-Konfiguraionsdatei laden.
  417.  
  418.  
  419.                                Installation
  420.  
  421.      Wollen Sie SMaus bei jedem Bootvorgang  starten,  so  ziehen  Sie
  422.      einfach das Piktogramm von SMaus in die Schublade WBStartup Ihrer
  423.      Workbench. SMaus wird dann  automatisch gestartet.  Wie Sie SMaus
  424.      dazu bringen, andere Sprachen, z.B. deutsch,  zu benutzen, können
  425.      Sie unter der Überschrift Sprachen lesen.
  426.      Wenn Sie SMaus in Ihrer User-Startup Datei starten wollen, fügen
  427.      Sie die Zeile
  428.  
  429.                      Run >NIL: <Pfad>SMaus <Optionen>
  430.  
  431.      zu dieser Datei, nachdem Sie <Pfad>  durch den Pfad zu  SMaus er-
  432.      setzt haben und <Optionen> durch gewünschte Optionen. Beispiel:
  433.  
  434.                Run >NIL: SYS:Tools/SMaus from s:SMaus.config
  435.  
  436.  
  437.                                 Tool Types
  438.  
  439.      Damit Sie nicht jedesmal die Einstellungen Ihren  Wünschen  gemäß
  440.      ändern müssen, können  Sie  diese  in  einer  Konfigurationsdatei
  441.      speichern oder im Piktogramm von SMaus angeben. Klicken  Sie  das
  442.      SMaus-Piktogramm einmal mit der linken Maustaste  an  und  wählen
  443.      Sie den Menüpunkt Information des Icons-Menü  der  Workbench.  In
  444.      dem sich öffnenden Fenster sehen Sie die Liste  der  Tool  Types.
  445.      Mit Hilfe dieser Tool Types übergeben Sie SMaus  die  gewünschten
  446.      Einstellungen. Folgende Tool Types kennt SMaus:
  447.  
  448.      From=<Dateiname>           Die Konfigurationsdatei, deren Pfad
  449.                                 und Namen (z.B. s:SMaus.konfig) Sie
  450.                                 für <Dateiname> einsetzen, wird ge-
  451.                                 laden. Werden gleiche Optionen in
  452.                                 einer Konfigurationsdatei und per Tool
  453.                                 Types angegeben, so haben Tool Types
  454.                                 vorrang. Soll SMaus eine Konfigura-
  455.                                 tionsdatei lesen, muß dieser Tool Type
  456.                                 in das Icon eingetragen werden.
  457.  
  458.      CX_Priority=<Zahl>         Für <Zahl> tragen Sie die gewümschte
  459.                                 Priorität von SMaus in der Liste der
  460.                                 Commodities ein.
  461.  
  462.      CX_Popkey=<Zeichenkette>   <Zeichenkette> ersetzen Sie bitte mit
  463.                                 der Beschreibung der Tastenkombina-
  464.                                 tion, die das SMaus-Fenster öffnen
  465.                                 soll. Diese Option fehlt verständ-
  466.                                 licherweise bei SMaus_nowin.
  467.  
  468.      CX_Popup                   Ist dieses Tool Type vorhanden, so
  469.                                 öffnet SMaus nach dem Start sein
  470.                                 Fenster. Auch diese Option fehlt bei
  471.                                 SMaus_nowin.
  472.  
  473.      Timeout=<Zahl>             Für <Zahl> bitte die Anzahl der zehn-
  474.                                 tel Sekunden eintragen.
  475.  
  476.      Threshold=<Zahl>           <Zahl> ersetzen Sie durch die Anzahl
  477.                                 von Pixel/Event, ab denen SMaus ein
  478.                                 Fenster bei Mausbewegung nicht mehr
  479.                                 aktiviert.
  480.  
  481.      Priority=<Zahl>            Für <Zahl> setzen Sie die Prozeß-
  482.                                 priorität von SMaus ein (voreinge-
  483.                                 stelllt ist 19, bei Verwendung der
  484.                                 Option Tastendruck wird die Priorität
  485.                                 automatisch auf 21 erhöht).
  486.  
  487.      WindowNot=<Zeichenkette>   <Zeichenkette> ist die Liste der Ti-
  488.                                 tel von Fenstern, die nicht deakti-
  489.                                 viert werden.
  490.  
  491.      ScreenNot=<Zeichenkette>   Als <Zeichenkette> geben Sie die Ti-
  492.                                 tel von Bildschirmen an, auf denen
  493.                                 SMaus funktionslos ist.
  494.  
  495.      Keypress                   Geben Sie diesen Tool Type an, so
  496.                                 wird bei einem Tastendruck das Fenster
  497.                                 unter dem Mauspfeil aktiviert.
  498.  
  499.      MouseNever                 Dieser Tool Type schaltet die Option
  500.                                 "Mausbewegung aktiviert" aus.
  501.  
  502.      MouseAlways                Dieser Tool Type schaltet die Option
  503.                                 "Mausbewegung aktiviert immer" ein.
  504.  
  505.      NoStringGad                Mit Angabe dieses Schlüsselwortes wer-
  506.                                 den Fenster mit aktivem Texteingabe-
  507.                                 feld nicht deaktiviert
  508.  
  509.      Wollen Sie SMaus aus der Shell starten, können Sie ebenfalls Ihre
  510.      gewünschten Einstellungen angeben. Hier das Befehlsformat:
  511.  
  512.      SMaus [CX_Priority <Zahl>] [CX_Popkey <Zeichenkette>]
  513.            [From <Dateiname>] [CX_Popup] [Timeout <Zahl>]
  514.            [Threshold <Zahl>] [Priority <Zahl>]
  515.            [ScreenNot <Zeichenkette>] [WindowNot <Zeichenkette>]
  516.            [Keypress] [MouseNever] [MouseAlways] [NoStringGad]
  517.  
  518.      Hier noch die Befehlsschablone:
  519.  
  520.      CX_Priority/K/N,CX_Popkey/K,CX_Popup/S,Timeout/K/N,Threshold/K/N,
  521.      Priority/K/N,ScreenNot/K,WindowNot/K,Keypress/S,MouseNever/S,
  522.      MouseAlways/S,NoStringGad/S,From/K
  523.  
  524.      Wie Sie sehen, entsprechen diese Optionen den Tool  Types.  Bitte
  525.      beachten Sie, daß Optionen mit Leerzeichen  in  Anführungszeichen
  526.      eingeschlossen werden müssen, z.B.:
  527.  
  528.                             CX_Popkey "alt f1"
  529.  
  530.      Wollen Sie die Shell nach dem Start schliessen können, so  müssen
  531.      Sie SMaus mit Run >NIL: SMaus starten. Wollen  Sie SMaus  in  der
  532.      Datei S:User-Startup installieren, so tragen Sie  dort  ebenfalls
  533.      Run >NIL: SMaus ein. Eventuell müssen Sie noch den Pfad  zu SMaus
  534.      angeben, z.B. Run >NIL: Utilities/SMaus, wenn Sie  SMaus  in  die
  535.      Schublade Utilities Ihrer Workbench kopiert haben.
  536.  
  537.  
  538.                       Format der Konfigurationsdatei
  539.  
  540.      Die Konfigurationsdatei ist eine reine ASCII-Datei und  kann  auf
  541.      Wunsch auch mit einem Editor geschrieben  oder  geändert  werden.
  542.      Jede einzelne Zeile der Konfigurationsdatei muß  im  Prinzip  wie
  543.      die Kommandozeile aussehen, mit der Sie SMaus starten,  nur  ohne
  544.      Programmname. Tatsächlich wird die Konfigurationsdatei Zeile  für
  545.      Zeile mit derselben  Betriebssystemroutine (ReadArgs()) und  der-
  546.      selben  Befehlsschablone  eingelesen,   wie   normalerweise   die
  547.      Kommandozeile. Kommentarzeilen werden mit einem  ";"  eingeleitet
  548.      und enden am Ende der Zeile. Hier ein Beispiel:
  549.  
  550.      ---- Dateianfang ----
  551.      ; Besipielkonfigurationsdatei für SMaus
  552.      KeyPress NoStringGad
  553.      MouseAlways
  554.      Threshold 1
  555.      Timeout 10
  556.      ScreenNot "Post#?"
  557.      WindowNot "(Arq#?|#?equest #?|#?essage#?|System#?|#?eachten#?)"
  558.      CX_Popkey "lcommand control f2"
  559.      ---- Dateiende ----
  560.  
  561.      Bitte beachten Sie, daß  bei  Optionen  wie  z.B.  WindowNot  An-
  562.      führungszeichen  verwendet  werden   müssen,   wenn   Leerzeichen
  563.      vorkommen!  Beachten  Sie   bitte   auch,   daß   der   Menüpunkt
  564.      "Konfigurationsdatei speichern" die Konfigurationsdatei  komplett
  565.      neu erzeugt  und  eventuell  von  Ihnen  hinzugefügte  Kommentare
  566.      dadurch verloren gehen.
  567.  
  568.      Achtung: die Schlüsselwörter für  die  Optionen  haben  sich  mit
  569.      SMaus 1.15 geändert. Alte Konfigurationsdateien  können  deswegen
  570.      nicht gelesen werden und müssen neu erzeugt werden.
  571.  
  572.  
  573.                                SMaus_nowin
  574.  
  575.      SMaus_nowin ist eine Spezialversion von SMaus, die jediglich kein
  576.      Fenster hat, in dem man die Einstellungen ändern  kann.  Wer  das
  577.      Fenster von SMaus nur  selten  benötigt  und  Speicher  nicht  im
  578.      Überfluß  hat,  spart  mit  dieser  Version  ein  paar  Kilobytes
  579.      Speicher.  Einstellungen  können  bei  dieser  Version  nur  über
  580.      Shell-Parameter oder Tool Types  gemacht  werden.  Ansonsten  ist
  581.      alles wie bei SMaus.
  582.  
  583.  
  584.                                  Sprachen
  585.  
  586.      Wenn Sie die Workbench 2.1 oder höher haben, haben Sie eine Funk-
  587.      tionsbibliothek names locale.library.  Dank  der  locale.library,
  588.      können Programme  auf  einfache  Weise  mit  Hilfe  verschiedener
  589.      Sprachdateien in verschiedenen  Sprachen  auftreten.  SMaus  plus
  590.      Sprachdatei in deutscher Sprache ergibt ein SMaus  mit  deutscher
  591.      Benutzeroberfläche, deutschen Fehlermeldungen usw. Dies gilt  für
  592.      alle Sprachen, für die  eine  Sprachdatei  existiert.  Für  jedes
  593.      Programm muß so eine Sprachdatei jedoch extra  erzeugt  werden.
  594.      Für SMaus heißen solche Dateien SMaus.catalog.
  595.  
  596.      Die englische Sprachdatei ist  in  SMaus  fest  eingebaut,  daher
  597.      benutzt SMaus per Grundeinstellung die englische Sprache.
  598.  
  599.      Wollen Sie, daß SMaus die deutsche Sprache benutzt, so müssen Sie
  600.      erstens in dem Preferences-Editor Locale, sie finden ihn auf  der
  601.      Workbench2.1 bzw.  Extras2.1  Diskette,  als  bevorzugte  Sprache
  602.      "deutsch"  an  erster  Position  auswählen.  Zweitens   muß   die
  603.      locale.library die Sprachdatei deutsch/SMaus.catalog finden.  Die
  604.      locale.library sucht die  Datei  zunächst  in  einem  Verzeichnis
  605.      Catalogs/Deutsch des Verzeichnisses, in  dem  sich  das  Programm
  606.      SMaus   befindet.    Danach    sucht    sie    die    Datei    in
  607.      Locale:Catalogs/Deutsch.  Sie  haben  also  zwei   Möglichkeiten:
  608.      entweder Sie kopieren in dasselbe Verzeichnis, in dem sich  SMaus
  609.      befindet, auch das Verzeichnis  Catalogs  der  SMaus-Distribution
  610.      samt Unterverzeichnissen, oder Sie kopieren die Datei
  611.  
  612.                       Catalogs/deutsch/SMaus.catalog
  613.  
  614.      nach
  615.  
  616.                    Locale:Catalogs/Deutsch/SMaus.catalog
  617.  
  618.      Locale: ist normalerweise ein Assign auf das  Verzeichnis  Locale
  619.      der Bootpartition/Bootdiskette.
  620.  
  621.      SMaus erkennt einen Wechsel der Sprache nicht. Sie  müssen  SMaus
  622.      beenden und neu starten, um in den Genuß einer anderen Sprache zu
  623.      kommen.
  624.  
  625.      Obiges gilt nicht nur für die deutsche Sprachdatei,  sondern  für
  626.      alle Sprachdateien.
  627.  
  628.  
  629.                     SMaus in andere Sprachen übersetzen
  630.  
  631.      Mit dem Softwareentwicklungswerkzeug CatComp von  Commodore  kann
  632.      man Sprachdateien für die locale.library erzeugen,  so  auch  die
  633.      Sprachdateien für SMaus.
  634.  
  635.      Sollten Sie das Programm CatComp besitzen, können Sie sich eigene
  636.      Sprachdateien erzeugen.
  637.  
  638.      Erzeugen  Sie  sich   zuerst   mit   "CatComp   SMaus.cd   CTFILE
  639.      Catalogs/<Sprache>/SMaus.ct"  eine   leere   "Translation"-Datei.
  640.      Fügen  sie  nun  in  den  leeren  Zeilen  die   Übersetzung   des
  641.      darunterliegenden englischen Textes  ein.  In  der  ersten  Zeile
  642.      tragen sie noch SMaus.catalog und die Versionnummer 1.0  ein.  In
  643.      der dritten Zeile  müssen Sie noch den Namen der Sprache angeben,
  644.      so wie Sie ihn im Locale Prefs-Editor einstellen können.
  645.  
  646.      Mit
  647.                "CatComp SMaus.cd Catalogs/<Sprache>/SMaus.ct
  648.                  CATALOG catalogs/<Sprache>/SMaus.catalog"
  649.  
  650.      erzeugen Sie dann die entgültige Sprachdatei.
  651.  
  652.      Wenn Sie SMaus in andere  Sprachen  übersetzen,  wäre  ich  Ihnen
  653.      dankbar, wenn Sie mir  die  Übersetzungsdatei  SMaus.ct  zukommen
  654.      lassen würden.
  655.  
  656.  
  657.                           Was hat sich geändert?
  658.  
  659.      V1.09   erste veröffentlichte Version
  660.      V1.10   kleine, interne Verbesserungen; Abkürzungen für Parameter
  661.              Spezialversion ohne Fenster
  662.      V1.11   Routine, die das Fenster zentriert, war fehlerhaft
  663.      V1.12   Option Mausnie hinzugefügt
  664.      V1.13   Konfiguration kann in einer Textdatei gespeichert werden
  665.              und von dort geladen werden. Eigentlich wollte ich die
  666.              Konfiguration im zugehörigen Icon Speichern, jedoch ist
  667.              laut RKM Libraries jedes Tool Types auf 128 Zeichen be-
  668.              grenzt. Dies könnte für Fensternicht etc. schnell zu wenig
  669.              werden. Deswegen eine ASCII-Datei zur Konfiguration.
  670.      V1.14   Kleiner Fehler im Zusammenhang mit dem Filerequester be-
  671.              hoben, der evtl. dazu führen kann, daß der Requester mit
  672.              der asl.library V37 nicht geöfnet wird.
  673.      V1.15   SMaus benutzt nun die locale.library. Das Übersetzen der
  674.              Optionen hat sich als schwierig erwiesen. Deswegen sind
  675.              nun alle Optionen englisch. Konfigurationsdateien müssen
  676.              deswegen neu angelegt werden. Sorry!
  677.      V1.16   interne Version
  678.      V1.17   Ein kleiner Fehler in der Routine, die die Konfigura-
  679.              tionsdatei ließt, konnte dazu führen, das ein paar Bytes
  680.              (ca. 140) nie mehr frei gegeben wurden.
  681.              Die Checkmark-Gadgets werden jetzt skaliert.
  682.              SMaus wird nun mit SAS/C 6.2 übersetzt.
  683.  
  684.  
  685.                                 Danksagung
  686.  
  687.      Vielen Dank an Michael Wolfgang Hohmann für die  Idee  zu  diesem
  688.      Programm und für das Testen. Ebenso an  Georg  Heßmann  für  neue
  689.      Ideen und das Testen.
  690.  
  691.  
  692.                                   Support
  693.  
  694.      Zögern Sie nicht, Vorschläge, Fehlerreports usw. an untenstehende
  695.      Adresse zu schicken.
  696.  
  697.  
  698.          Stefan Sticht
  699.          Bibereckerweg 40a
  700.          D-8390 Passau 18
  701.          Germany
  702.  
  703.          EMail: sticht@edith.deg.sub.org
  704.          Fido: Stefan Sticht (2:246/200.4)
  705.  
  706.  
  707.         Vielen Dank, wenn Sie SMaus Registrieren lassen!
  708.  
  709.         Gruß, Stefan Sticht
  710.  
  711.